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Background of the Invention 

Field of the Invention 

The present invention relates generally to managing resources in a 
telecommunications network or computer system environment. 

Related Art 

Telecommunications network products are services provided by telephone 
companies that are carried on telecommunications networks. A widely known 
example is dial-1 long distance voice service which allows a customer to dial a 1 
plus a ten digit number from his or her home telephone, talk to a party who 
answers the telephone on the line of the ten digit number dialed, and pay for the 
telephone call when billed at the end of the month. 

Although dial-1 is popular, other calling and payment options, also referred 
to as enhanced services, are sometimes preferable. For example, debit calling 
allows an individual to make a call from a phone other than their home phone and 
charge the call to the debit account. With debit calling, also referred to as prepaid 
calling, a customer puts funds in an account and has those funds debited each time 
a telephone call is made. Another calling and payment option is collect calling in 
which the call is billed to the receiving party's account. 

Enhanced services are not limited to other calling and payment options. 
Enhanced services can provide a customer with information such as access to 
news and weather. Another enhanced service is 1-800-MUSICNOW which gives 
a telephone caller the ability to select and listen to music and then order a 
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recording of the music by entering selections in response to menu prompts using 
the keypad of the telephone. 

Enhanced services are possible because intelligent services networks 
(ISNs) within telephone companies telecommunications networks have advanced 
capabilities needed to process the enhanced service calls. The ISNs are networks 
that comprise ISN components capable of performing enhanced service call 
processing functions. Exemplary ISN components include computer systems that 
store data and perform protocol conversion and exchanges, also referred to as 
switches that route calls. In addition, for processing enhanced service calls, 
information about customers, calls, and telecommunications services is needed. 

The information and ISN components are resources. Within a 
telecommunications network, resources are sources of assistance in performing 
functions needed to process calls. 

For example, information such as the destination number dialed by a caller 
provides assistance in call processing by providing the area code which can be 
translated to determine what telecommunications network circuits should be used 
by ISN components to route the call to the intended recipient. 

Information about resources may be obtained in multiple ways. For 
example, reports may be available that provide printed information about the 
resources. In addition, information may be available on-line by a human operator 
entering commands. Also, alarms may be generated that alert a human system 
overseer that a particular resource or group of resources is unavailable, 
malfunctioning, and/or in use more often than recommended. In typical ISNs, 
information is stored in an automated call distributor (ACD), an intelligent service 
network application processor (I SNAP), and other ISN components. The ACD 
provides the call switching, queuing, and protocol conversion functions. The 
intelligent service network applications processor (I SNAP) provides group 
selection functionality for the ISN. 

Information about the resources is typically stored in electronic format in 
one or more computer systems. Application programmer interfaces (APIs) may 
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be used to communicate call processing information and information about 
telecommunications components within a computer program. The APIs are 
procedures for communication within a computer program that reside in main 
memory and are processed by a processor. The APIs are used by programmable 
5 switches, such as the Excel programmable switch, to perform call processing 

functions. The API used by the Excel programmable switch is described in a 
document entitled, "Excel API specification revision 5.0." Additional APIs 
include the Tabman, Queman, Sysmem, and Shmman APIs that are described in 
more detail below. 

10 Typically, information about resources is handled in a non-standard, de- 

centralized manner. Information about various components within a 
telecommunications network is accessible via the particular component. For 
example, central processing unit (CPU) availability of a switch is obtained from 
the switch. Information about the processing capability of computer systems that 

15 assist the switch is stored in memory of the computer systems. In addition, 

information is only accessible using commands or APIs that can be understood by 
the component storing the information. For example, to access information about 
the switch, commands that can be understood by the switch must be used to obtain 
the data about the switch that is stored within the switch. To access information 

20 about a computer system assisting the switch, commands understood by the 

assisting computer system must be used. 

Summary of the Invention 

The present invention is a system and method for managing resources, 
more particularly ISN resources. Resource management is performed by a 
25 resource management routine within an application program that resides in the 

memory of a switch controller. The resource management routine manages 
internal switch controller resources and external resources such as programmable 
switches. 
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An ISN includes components which perform enhanced call handling 
functions, such as operator consoles and automated response units, and 
components that provide access to databases and other networks. Enhanced 
services, such as pre-paid service, calling card, operator service, 1-800- 
5 COLLECT, and 1-800-MUSIC-NOW are possible using the ISN. A switch 

controller is a telecommunications network component which controls the 
operation of one or more programmable switches and is capable of performing 
complex call processing to handle service specific features of enhanced 
telecommunications services. The switch controller provides an interface between 
10 the public switching telephone network (PSTN) and the intelligent service 

network (ISN). 

The present invention is a system-wide approach to resource management. 
The resource management routine provides standard procedures used by processes 
to obtain information about resources. In addition, the resource management 

15 routine provides controlled access to information about resources. The resource 

management routine is essentially a protective layer for information about 
resources. Compared to a library housing books which are resources for people 
to gain information, the resource management routine is a librarian which controls 
in a standardized way how resources are accessed by various different processes. 

20 The resource management routine comprises electronic libraries residing 

in memory of the switch controller that store information about resources and 
resource management application programmer interfaces (APIs) that are used to 
access the stored information. Resource management APIs are stored in the main 
memory and processed by the processor of a computer. In order to process the 

25 resource management API, the processor calls the resource management API 

procedure from main memory. The resource management API procedure 
executes commands using input data. Completion of the execution of the resource 
management API results in return data which is the data requested and/or data 
indicating whether the transaction was successful and an output which is an action 

30 requested by the initiating routine. 
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Resource management APIs are generic in that they are not affected by 
changes to other APIs or messaging techniques, such as APIs for internal switch 
controller processing, the Excel programmable switch APIs, or changes to ISN 
protocols. Having a generic resource management API provides various benefits, 
5 including flexibility and extensibility. Flexibility is possible because the resource 

management APIs are independent of the other messaging techniques. Therefore, 
resource management does not need to be upgraded with changes to other 
routines and computer systems. In addition, if a new resource is added, the 
resource management routine needs to be updated but the new resource has a 

1 0 minimal impact on other routines and computer systems. As a result, changes can 

be more readily made to the ISN. 

In addition, extensibility is improved with generic resource management 
APIs because new services can be more easily implemented. New services can be 
more easily implemented because modifications are not needed to the resource 

15 management routine unless implementation of the new service involves adding a 

new resource or modifying a resource such that access to data about that resource 
is affected. If a new resource is added or an existing resource is modified, changes 
are needed to the APIs associated with that resource and are not needed system 
wide. 

20 Furthermore, maintenance and debugging of resource management 

routines within the switch controller are simplified and more accurate. 
Maintenance and debugging are simplified and more accurate because resource 
management APIs are standardized for the various resources. In other words, 
resource management APIs follow similar procedures when possible although the 

25 information is being accessed about different resources. As a result, resolution of 

maintenance and debugging issues for one resource management API is applicable 
to other resource management APIs. Also, resource management APIs are 
grouped within the same resource management routine. Therefore, maintenance 
and debugging resource management code involves accessing one routine and not 

30 attempting to identify resource management functionality within various processes 
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and routines. Furthermore, individual routines are not required to have unique 
procedures and code for accessing information about resources. In addition to 
providing standard procedures, the generic resource management routine, which 
is available to routines requiring information about resources, reduces the overall 
5 code required to access resources. 

Further features and advantages of the invention, as well as the structure 
and operation of various embodiments of the invention, are described in detail 
below with reference to the accompanying drawings. 

Brief Description of the Figures and Tables 

1 0 The present invention is described with reference to the accompanying 

drawings wherein: 

Fig. 1 is a block diagram of an exemplary embodiment of a resource 
management environment according to one embodiment of the present invention; 
Fig. 2 is a block diagram of the hardware configuration of a switch 
15 controller according to one embodiment of the present invention; 

Fig. 3 is a flowchart of a resource management environment according to 
one embodiment of the present invention; 

Fig. 4 is a block diagram of a resource management interface according to 
one embodiment of the present invention; 
20 Fig. 5 illustrates the operation of a resource management process flow 

according to one embodiment of the present invention; 

Fig. 6 is a diagram of an exemplary embodiment of resource management 
according to one embodiment of the present invention; and 

Tables 1-69 illustrate application programmer interfaces and data 
25 structures according to one embodiment of the present invention. 

In the drawings like reference numbers generally indicate identical 
functionally similar and/or structurally similar components. The drawing in which 
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an element first appears is indicated by the left most digits in the corresponding 
reference number. 

Detailed Description of the Preferred Embodiments 
1.0 Overview 

5 Resource management within a switch controller provides management of 

intelligent service network (ISN) resources. A resource management routine 
within an application program residing in the memory of the switch controller 
manages resources by providing a protective layer of standard procedures, 
referred to as resource management application programmer interfaces (APIs) that 

10 are used to access information about ISN resources. The information about the 

ISN resources is stored electronically in memory and is organized in table format. 
The electronically stored data is referred to as the resource manager tables. 

The ISN resources are resources associated with an ISN. An ISN is a 
network of components that perform functions to provide enhanced services, such 

15 as pre-paid service, calling card, operator service, 1-800-COLLECT, and 

1-800-MUSIC-NOW. The ISN resources are sources of assistance in performing 
functions to provide enhanced services. The ISN components, such as operator 
consoles and automated response units, provide capabilities needed to process 
enhanced service calls and are ISN resources. In addition, information related to 

20 call processing is also an ISN resource. 

The resource management routine resides within the memory of a switch 
controller. A switch controller is a telecommunications network component which 
provides an interface between the public switching telephone network (PSTN) and 
an intelligent service network (ISN). The switch controller provides control over 

25 ISN components, including one or more programmable switches, manual operator 

consoles, and automated response units (ARUs). In addition, the switch controller 
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is capable of performing complex call processing to handle service specific 
features of enhanced telecommunications services. 

The resource management routine comprises electronic libraries referred 
to as resource manager tables residing in memory of the switch controller that 
5 store information about resources and resource management application 

programmer interfaces (APIs) that are used to access the stored information. 
Resource management APIs are stored in the main memory and processed by the 
processor of a computer. In order to process the resource management API, the 
processor calls the resource management API procedure from main memory. The 
1 0 resource management API procedure executes commands using input data. The 

resource management API returns a response message that includes requested 
information and/or indication of whether the transaction was successful. The 
resource management API also results in an action requested by the initiating 
routine. 

15 2.0 Example Resource Management En vironment 

FIG. 1 is a block diagram of an exemplary embodiment of a resource 
management environment 102 according to one embodiment of the present 
invention. The switch controller 1 12 within the ISN 126 provides access for a call 
initiated via telecommunications switching network 108 to ISN components 122a, 

20 122b, ...122n also within ISN 126. Except as otherwise noted, when the ISN 

components 122 are referred to generally, they will be referred to by number 
designation only and not a letter designation. The resource management routine 
which resides in memory of the switch controller 1 12 provides management of 
ISN 126 resources. The ISN 126 is described in further detail in copending U.S. 

25 Patent Application Attorney Docket No. CDR-97-007 (1 595.2790000) entitled, 

"Intelligent Service Network," incorporated by reference herein in its entirety. 

The ISN environment 102 includes telephone 104 used by a caller, a 
telecommunications switching network 108, and an ISN 126. The telephone 104 
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used by the caller is connected to telecommunications switching network 108. 
The telecommunications switching network 108 provides switching and 
connectivity to the ISN 126. The ISN components 122 provide enhanced service 
call processing and connectivity to external networks and resources. Enhanced 
5 services include manual operator service, prepaid calling, calling card, 1-800- 

COLLECT, and 1-800-MUSICNOW. External networks and resources include 
financial processors, information databases, and Internet facilities. 

The ISN 126 includes a programmable switch 1 10, a switch controller 1 12, 
LANs, WANs, and routers 120, and ISN components 122. The programmable 

1 0 switch 1 1 0 is connected to the telecommunications switching network 1 08 to 

provide switching capabilities for access to the ISN 126. The switch controller 
112 is interconnected to programmable switch 110 to provide commands to 
control the programmable switch 110. The LANs, WANs, and routers 120 are 
connected to switch controller 112 and the ISN components 122 to provide 

15 connectivity between the switch controller 112 and the ISN components 122. 

Exemplary ISN components 122 include manual operator consoles (MOCs), 
automated response units (ARUs), databases, and protocol converters. The 
MOCs and ARUs are personal computers (PCS) that interact with a caller to 
provide operator services, customer services, and other enhanced services. 

20 Databases contain stored information and may be a single database or multiple 

databases connected to and controlled by a server systems. Protocol converters 
are connected to external networks and resources and provide protocol conversion 
and other processing necessary for interface between the telecommunications 
switching network 108 and external networks and resources. 

25 The exemplary embodiment of a resource management environment 1 02 

can best be described referencing the processing of a typical call. The exemplary 
call will be for a service that requires human operator intervention. The call is 
placed by a caller using telephone 104. The call is received by telecommunications 
switching network 108. The telecommunications switching network 108 

30 comprises multiple telecommunications networks including local exchange 
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networks and interexchange networks. A local exchange network comprises 
switches and termination equipment within a localized area. An example of a local 
exchange network is a local telephone operating company network, such as Bell 
Atlantic. An interexchange network comprises a plurality of switches, also 
referred to as exchanges, distributed throughout a geographic area large enough 
to process long distance telephone calls. For example, a national interexchange 
network comprises switches located throughout the nation. When the call is 
routed to either a local exchange network or an interexchange network, the call 
is routed to one or more switches within the network. 

The telecommunications switching network 108 is interconnected to the 
programmable switch 110 within the ISN 126. The programmable switch 1 10 has 
a basic switching matrix that provides switching functionality for access to the ISN 
126. An ISN 126 may include additional programmable switches (not shown) 
interconnected to switch controller 1 12 or to additional switch controllers (not 
shown). The programmable switch is a dumb switch that can connect ports and 
process calls based on external commands. Examples of programmable switches 
include those built by Excel and Summa Four. Excel programmable switches 
come in sizes ranging from 512 ports to 8,000 ports. 

The ISN 126 has a sizable architecture because the number of 
programmable switches 1 1 0 and the configuration of the programmable switches 
1 10 can vary depending on the desired port requirement of the ISN 126. Excel 
programmable switches can support various signaling systems such as Signaling 
System Number 7 (SS7) and can be connected directly to the signaling network 
of a telecommunications switching network 108. If multiple programmable 
switches are interconnected to one or more switch controllers, connections 
between the programmable switches and the switch controllers are most likely via 
a LAN (not shown), such as an Ethernet LAN, using transmission control 
protocol/internet protocol (TCP/IP). Transmission control protocol/internet 
protocol is used by various data networks including many Internet servers. 
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Each programmable switch 1 1 0 is connected to the telecommunications 
switching network 108 via voice telephony trunks, also referred to as lines. 
Typical telephony trunks are capable of carrying high speed digital data. The 
voice trunk connectivity between the programmable switch 110 and the 
5 telecommunications switching network 108 includes signaling, such as SS7 

protocol. The current industry standard of SS7 protocol is published in the 
International Telecommunications Union (ITU) Signaling System Number 7 (SS7) 
Integrated Services Digital Network (ISDN) User Part (ISUP) NCT1 .113 (1995) 
document and the International Telecommunications Union (ITU) Signaling 

10 System 7 (SS7) Message Transfer Part (MTP) NCT 1.111 (1992) document 

which are incorporated herein by reference in their entirety. Signaling System 7 
may be implemented using SS7 signaling rings (not shown) connected to a signal 
transfer point (not shown). Some ISN 126 architectures may use signaling 
gateways between the signaling transfer point and the programmable switch 

15 although this is not necessary if the programmable switch is capable of the 

signaling used by the telecommunications switching network 108. 

Switch controller 1 12 is connected to programmable switch 1 10 to provide 
external commands to control call processing. The switch controller 1 12 provides 
the commands to the programmable switch 1 1 0 to perform call processing 

20 functions. When the programmable switch 1 1 0 receives a call from the network 

it sends a message to the switch controller 112. The switch controller 112 
determines the call processing needed and returns commands to the programmable 
switch 110. 

In addition, the switch controller 112 provides access to ISN components 
25 122. The switch controller interfaces with ISN components 122 via LANs, 

WANs, routers (or any other connectivity) 114 using Network Information 
Distribution System (NIDS) Sequenced Packet Protocol (NSPP) on top of User 
Datagram Protocol/Internet Protocol (UDP/IP). Network Information 
Distribution System Sequenced Packet Protocol is a session oriented packet 
30 exchange protocol that is implemented over UDP/IP. It is designed to allow rapid 
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information exchange between client applications and NIDS server processes. The 
use of TCP/IP between switch controller 1 12 and the programmable switch 1 10 
and the use of NSPP/UDP/IP for communications via LANs, WANs, routers (or 
any other connectivity) 1 14 illustrate exemplary protocols but the ISN 126 is not 
limited to these protocols. 

Stored within memory of the switch controller 1 12 is the switch controller 
application program 118 which is the computer program that performs the 
functionality associated with switch controller 112. The switch controller 
application program 1 1 8 is processed by a processor. The architecture of the 
switch controller 1 12 will be described in further detail with respect to FIG. 2. 

The resource management routine 114 resides in memory of the switch 
controller 112 within the switch controller application program 118. In one 
embodiment of the present invention, the resource management routine is within 
a resource control function. The resource control function is a process within the 
switch controller application program 1 1 8 that both provides management of 
resources and monitors resources. Resources are managed by the resource 
management routine 114. Monitoring is performed by a system control process, 
also within the resource control process. The system control process monitors call 
states and service related resources. 

Switch controller application program routines 116A, 116B, 116C, ... 
1 16n reside in memory of the switch controller 1 12 within the switch controller 
application program 1 1 8 and, when executed, perform enhanced service call 
processing and other functions needed to provide an interface between the 
telecommunications switching network 108 and the ISN components 122. Except 
as otherwise noted, when the switch controller application program routines 116 
are referred to generally, they will be referred to with the number designation only 
and not a letter designation. The routines within the switch controller application 
program 1 1 8 include the resource control function (described above), the 
programmable switch support function, the call control function, the service 
control function, and the management interface function. 
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The programmable switch support function provides an interface between 
the switch controller 112 and the programmable switch 110. The programmable 
switch support function translates messages between a generic switch controller 
API message format and programmable switch API message format, manages 
5 message header/trailer requirements, and controls connectivity to the 

programmable switch 110. 

The call control function provides service independent call processing. 
The call control function performs call processing by analyzing call processing 
information with respect to the current state as defined by the basic call state 

10 machine model. Each call has two states represented in the state machine for the 

originating and terminating call segments. The basic call state machine model is 
described further in the International Telecommunications Union (ITU) 
specifications Q.1224. The call control function performs various functions 
including but not limited to: detecting an incoming call, creating an originating call 

1 5 model, collecting originating dial digits, requesting analysis of the digits, selecting 

trunk groups, creating a terminating call model, composing and sending messages 
to the terminating agent or party, detecting ISUP messages, detecting disconnect 
signals, and triggering enhanced services. 

The call control function trigger features and services from the service 

20 control function. The service control function provides an interface to the ISN 

126 and one or more service logic programs that provide enhanced service call 
processing. The service control function is made up of the switch service process, 
the group select process, call queuing process, and the prepaid service logic 
process. In order to provide an interface to the ISN 126, the switch service 

25 process connects between SCAPI used by the switch controller and NSPP used 

by ISN 126. 

The management interface function includes two functional areas of 
monitoring control. The system monitoring functionality encompasses the 
generation of system alarms which allows a system management console to 
30 monitor the status and run-time operation of the switch controller software. The 
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management interface function also includes the process manager, which is 
responsible for initial startup and health of individual processes which make up the 
switch controller 1 12. 

The ISN components 122A, 122B, ... 122n (122) include components that 
provide enhanced service functionality call and connectivity to external networks 
and resources. Except as otherwise noted, when the ISN components 122 are 
referred to generally, they will be referred to with the number designation only and 
not a letter designation. One example of an ISN component 122 is the MOC. The 
MOC is PC workstation that is operated by a live operator or call center agent to 
provide operator services, customer services, and other enhanced services 
requiring human operator intervention. Another example of an ISN component 
122 is the ARU. The ARU is comprised of a network audio server (NAS) and an 
automated call processor (ACP). The ARU is used to provide automated operator 
services and interactive voice response services. The ACP is a high performance 
personal or midrange computer that performs intelligent application processing to 
determine which services to provide. The NAS is a specialized computer 
equipped with telephony ports which provides audio responses and collects caller 
input via dual tone multifrequency (DTMF) signals and voice recognition based 
on commands provided by the ACP. The ACPs communicate with the NASs via 
LANs, WANs, and routers 120. Each ARU/NAS and MOC is connected to one 
or more programmable switches via voice trunks (not shown). Both MOCs and 
ARUs are also referred to as agents. 

An additional example of an ISN component 122 is aNIDS server and 
database. A NIDS server and database stores data related to call processing such 
as customer accounts and routing translations. When an ISN component, such as 
an ARU or a MOC, receives a call, it may query a NIDS server for data stored in 
the NIDS database. The NIDS servers receive data from mainframe-based 
systems to be used during real time call processing. Order entry and data 
management functions are performed within mainframe based systems. Mainframe 
computers are used as the databases of record for call processing data. A data 
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distribution system (DDS) distributes the call processing data stored in the 
mainframe computers over a token ring LAN to each NIDS server. 

The ISN components also include protocol converters that convert 
between various telecommunications protocols. Protocol converters provide 
protocol conversion between different protocols such as TCP/IP, NSPP on top of 
UDP/IP, and packet switching protocols, such as X.25. Exemplary components 
that perform protocol conversion are described in U.S. Patent Application No. 
08/967,339 filed October 21, 1997 entitled, "Advanced Intelligent Network 
Gateway" and U.S. Patent Application No. 08/956,220 fded October 21, 1997 
entitled, "Validation Gateway," both of which are incorporated herein by reference 
in their entirety. Additional ISN components 122 are described in copending U.S. 
Patent Application No. 08/956,232 filed October 21, 1997 entitled, "A System and 
Method for Providing Operator and Customer Services for Intelligent Overlay 
Networks," incorporated herein by reference in its entirety. 

Additional ISN components 122 include standalone PC workstations for 
system management, force management and configuration provisioning. 

Some ISN components 122, such as protocol converters, are connected 
to external networks and resources. Exemplary external networks and resources 
include financial processors with credit card information, the Internet, and other 
databases, such as those used in processing international calls. 

3.0 Resource Management within the Switch Controller 

The switch controller application program 1 18 of the present invention is 
preferably implemented using a computer system 202 as shown in block diagram 
form in FIG. 2. The computer system 202 includes one or more processors such 
as processor 206 connected to bus 204. Also connected to bus 204 is main 
memory 208 preferably random access memory (RAM) and secondary storage 
devices 210, secondary storage devices 210 include for example a hard drive 212 
and a removable storage medium storage device 214 such as a disk drive. 
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The switch controller application program 1 1 8 is preferably a computer 
program that resides in main memory 208 while executing. Thus, the switch 
controller application program 1 1 8 represents the controller of the computer 
system 202 (and of the processor 206). Alternately, the switch controller 
application program 1 1 8 is predominantly or entirely a hardware device such as 
a hardware state machine. 

In one embodiment, the present invention is a computer program product 
such as removable storage medium 216 representing a computer storage disk, 
compact disk etc., comprising a computer readable media having control logic 
recorded thereon. The control logic, when loaded into main memory 208 and 
executed by processor 206, enables the processor 206 to perform operations as 
described herein. The switch controller application program 118 includes 
commands which comprise the resource management routine 114 which, in one 
embodiment of the present invention, reside in main memory 208 and are 
processed by the processor 206. 

FIG. 3 is a block diagram of a resource management environment 302 
according to one embodiment of the present invention. The block diagram of a 
resource management environment 302 illustrates the protective layer concept of 
the resource management routine 114. Within the resource management routine 
114 are resource managers 304A, 304B, 304C ... 304n (304). Resource 
requesters 306A, 306B, 306C ...306n (306) obtain information about resources 
31 OA, 31 0B, 3 10C ... 31 On (310) by communicating with the resource managers 
304. Thus, the resource managers 304 provide a protective layer for the resources 
310. Except as otherwise noted, when the resource managers 304, resources 310, 
and resource requesters 306 are referred to generally, they will be referred to with 
the number designation only and not a letter designation. 

The resource management routine 114 comprises the resource managers 
including resource manager (1) 304A, resource manager (2) 304B, resource 
manager (3) 304C, and resource manager n 304n. 
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Resources 310 include the equipment comprising the ISN 126 and 
enhanced service call processing information. Equipment comprising the ISN 126 
includes the components comprising the programmable switch 110, components 
comprising the switch controller 1 12, and ISN components 122. Examples of 
components comprising the programmable switch 110 are ports, central 
processing unit (CPU) capacity, switch matrix, etc. Examples of components 
comprising the switch controller 1 12 are CPU capacity, shared memory capacity, 
etc. In addition, enhanced service call processing information is a resource 310. 
Enhanced service call processing information includes information about enhanced 
service calls, such as call identification numbers, leg identifiers, billing time points, 
etc. 

Resource requesters 306 include the switch controller application program 
routines 1 1 6 (system control process, programmable switch support function, call 
control function, service control function, and management interface function). 
In addition, any routine in a computer program in a telecommunications network 
component that can access the resource management routine 1 1 4 may be a 
resource requester 306. 

Each resource manager 304 provides a protective interface for a particular 
corresponding resource 310. For example, resource manager (1) 3 04 A provides 
a protective interface for resource (1) 3 10A. If a resource requester 306 wants 
information about a resource 310, the resource requester interfaces with the 
appropriate resource manager 304. For example, FIG. 3 illustrates resource 
requester (3) 306C requesting information from both resource manager (1) 304A 
to gain information about resource (1) 31 OA, and resource manager (3) 304C, to 
gain information about resource (3) 3 IOC. If resource requester (3) is the service 
control function, the service control function may request information about 
agents and call data block information. The service control function would access 
a resource manager for information about the agents and another resource 
manager for information from the call data block. 

MCI Ref. No.: CDR-97-031 
SKGF Ref. No.: 1575.3000000 



-18- 



Multiple resource requesters 306 may obtain information about a resource 
310 by accessing the appropriate resource manager 304. For example, resource 
requester (1) 306A and resource requester (2) 306B request information from 
resource manager (2) 304B to gain information about resource (2) 310B. If the 
5 programmable switch support function and the management interface function 

need information about a component of the programmable switch 110, both 
routines access the resource manager 304 corresponding to the programmable 
switch component 110. 

FIG. 4 is a block diagram of a resource management interface 402. The 

10 resource management routine 1 14 provides the resource management interface 

402. The resource management interface 402 illustrates that in order to access 
information about a resource 310, a resource requester 306 accesses the 
appropriate resource manager 304. Exemplary resource requester (1) 306A 
accesses resource manager (2) 304B to obtain information about a corresponding 

15 resource (2) 3 10B. If exemplary resource requester (1) 306A needs information 

about resource (1) 31 OA or resource n 31 On, the resource requester (1) 306A will 
access the corresponding resource manager 304, particularly resource manager (1) 
3 04 A or resource manager n 31 On respectively. As a result, information about 
resources 310 is accessed in a standardized manner by each of the resource 

20 requesters 306. In addition, the resource requesters 306 are not required to have 

individual procedures for accessing information about resources 310. Rather, the 
resource requesters 306 use the generic procedures within the resource manager 
304. 

Each resource manager 304 includes one or more resource manager 
25 application programmer interfaces (APIs) 404 and one or more resource manager 

tables 406, referred to interchangeably as electronic libraries. For example, 
resource manager (1) 304A includes resource manager API(s) (1) 404 A and 
resource manager table(s) (1) 406a; resource manager (2) 304B includes resource 
manager API(s) (2) 404B and resource manager table(s) (2) 406B; and resource 
30 manager n 304n includes resource manager API(s) n 404n and resource manager 
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table(s) n 406n. Except as otherwise noted, when the resource manager APIs 404 
and resource manager tables 406 are referred to generally, they will be referred to 
with the number designation only and not a letter designation. 

The resource manager tables 406 reside in memory of the switch controller 
and store information about resources 310. The resource management APIs 404 
are procedures that are used to access the stored information. Resource 
management APIs 404 are commands that are stored in the main memory and 
processed by the processor of a computer. In order to process a resource 
management API 404, the processor calls the resource management API 404 from 
main memory. The resource management API 404 processes by executing 
commands using input data. Completion of the execution of the resource 
management API 404 results in return data which is the data requested and/or data 
indicating whether the transaction was successful and an output which is an action 
requested by the initiating routine. 

FIG. 5 illustrates the operation of resource manager process flow 502. In 
step 506 the resource requester sends a query to the appropriate resource manager 
304 using the resource manager API 404. For example, as shown in FIG. 4 
resource requester (1) 306A would send a query using the resource manager API 
(2) 404B to resource manager (2) 304B to access information in resource manager 
tables (2) 406B. The switch controller uses UNIX interprocess communications 
(IPC) capabilities in order to facilitate communication among the routines of the 
switch controller. Particularly, UNIX IPC queues and shared memory capabilities 
are used. 

Switch controller application program routines 1 1 6 send queries to well 
known IPC queues. The queries contain a reference pointer to shared memory. 
The shared memory is dynamically allocated and contains data needed to perform 
the resource manager API 404 request. The processor 206 (shown in FIG. 2) 
executes the resource manager API 404 commands residing in memory which 
preferably is main memory 208 but may be secondary memory 210 including hard 
disk 212 or a removable medium 216. In the example above, the processor 
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executing the resource manager (2) API 404B commands generates a query which 
is sent from the resource requester (1) 306A (shown in FIG. 4 and FIG. 3) to a 
queue associated with resource manager (2) 304B. The queue includes a 
reference pointer to shared memory with data needed to retrieve information 
about the resource 310. 

For example, if the resource requester 306 is the call control function, an 
exemplary communication is the call control function writing call information to 
the call data block. In the example, the call information is the resource (2) 31 OB. 
The call control function will send a query using the call data block resource 
manager API 404 to set information in the call data block. The call data block is 
the resource manager table 406. 

In step 508 data is retrieved or updated in the appropriate resource 
managers table 406. In order to retrieve data from or update a resource manager 
table 406, the resource manager 304 retrieves the reference pointer contained in 
the query that was sent in step 506, accesses the shared memory pointed to by the 
reference pointer, and retrieves data from shared memory needed to retrieve data 
from or update the resource manager table 406. In the example illustrated in 
FIG. 4, the resource manager (2) 304B retrieves the reference pointer in the query 
sent by resource requester (1) 3 06 A in step 506, accesses the shared memory 
pointed to by the reference pointer, and retrieves the data from shared memory 
needed to retrieve data from or update the resource manager table (2) 406B. 

After retrieving the data from shared memory, the resource manager 304 
performs the requested resource manager API 404 procedure which involves 
retrieving information from or updating the resource manager table 406. In the 
example illustrated in FIG. 4, the resource manager (2) 304B performs the 
resource manager API (2) 404B procedure and retrieves information from or 
updates resource manager table (2) 406B. 

For an exemplary request by the call control function to write information 
to the call data block, the call data block resource manager will retrieve the 
reference pointer from the query sent by the call control function (which is the 
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resource requester 306). The call data block resource manager will access shared 
memory pointed to by the reference pointer and retrieve the data from shared 
memory to retrieve data from or update the call data block, which is the call data 
block resource manager table. Exemplary data includes a call identifier that can 
be used to access the call data block information for a particular call. The call data 
block resource manager will write the data to the call data block. The call data 
block resource manager API and call data block table will be described in further 
detail with respect to FIG. 6. 

To ensure that multiple resource requesters 306 do not access the same 
information within a resource manager table 406, a semaphore variable is set if a 
resource requester 306 is accessing information. A semaphore variable is a 
variable that has two possible values, one value indicating that data may be 
accessed and another value indicating that data may not be accessed. Semaphore 
variables may control access of a table or of just one data element within a table. 
Semaphore variables are resources as they are needed for enhanced service call 
processing. Procedures for retrieving information about or updating semaphore 
variables are defined by the semaphore variable APIs. Information about 
semaphore variables, such as the value of the variable, is stored in a semaphore 
variable table. 

In step 510 the resource manager 304 responds using the resource 
manager API 404. Completion of the execution of the resource manager API 404 
results in return data which is the data requested and/or data indicating whether 
the transaction was successful. Also, the completion of the execution of the 
resource manager API 404 may result in an output, which is an action requested 
by the initiating routine. Neither return data nor output is necessary for successful 
processing by the resource management API 404 but may be useful in providing 
data and/or ensuring a transaction completed successfully. 
4. 0 Exemplary Resource Management Embodiment 

A. Overview 
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Fig. 6 is a block diagram 602 of an exemplary embodiment of a resource 
management 114. Resource management 114 includes numerous resource 
managers 604-622. In one embodiment, these resource managers include the 
tabman resource manager 604, queman resource manager 606, sysmem resource 
manager 608, shmman resource manager 610, semaphore resource manager 612, 
switch controller resource manager 614, agent resource manager 616, call data 
block resource manager 618, service logic program resource manager 620 and 
switch resource resource manager 622. These various resource managers are 
described in further detail in Tables 1-69. 

B. Tables 

1. 0 Tabman Resource Manager 604 
API Tables 

Tabman Client Table APIs 
Tabman Service Descriptor APIs 
Tabman Service Table APIs 
Other Tabman APIs 

Data Structure Tables 

Tabman Client Table Data Structure Table 67 

Tabman Service Descriptor Table 

Data Structure Table 68 

Tabman Service Table Data Structure Table 69 

2.0 Queman Resource Manager 606 

API Table 
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Queman APIs Table 64 

3. 0 Sysmem Resource Manager 608 
API Table 

Sysmem APIs Table 65 

4. 0 Shmman Resource Manager 610 
API Table 

Shmman APIs Table 66 

5.0 Semaphore Resource Manager 612 
API Table 

Semaphore APIs Table 1 

6.0 Switch Controller Resource Manager 614 
API Tables 

Switch Controller Common Library 

Memory Segment APIs 
Operational Measurements Area APIs 
Heartbeat Table APIs 

Data Structure Tables 
IPC Table 

Switch Controller CPU Availability 
Switch Controller Disk Availability 



Table 2 
Table 3 
Table 4 



Table 12 
Table 13 
Table 14 
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Agent Operational Measurement Counts Table 1 5 
Switch Port Operational Measurement 

Counts Table 16 

Control Table for Heartbeat Table Table 1 7 

Heartbeat Table Table 18 

7. 0 Agent Resource Manager 61 6 



10 



API Table 

Agent Memory Segment APIs 
Agent Table APIs 
Group Table APIs 
Assignment Table APIs 



Table 5 
Table 6 
Table 7 
Table 8 



15 



20 



25 



Data Structure Table 
Control Table for Agent Table 
Agent Table 
Agent Attributes Table 
Agent Time Stamps Table 
Agent Counts Table 
Control Table for Group Table 
Group Table 

Calls Queued Per Group Table 
Control Assignment Table 
Assignment Table 
Assignment Data Table 
Mapping Table 
Fast Search for Agent Table 
Group Search Table 



Table 19 
Table 20 
Table 21 
Table 22 
Table 23 
Table 24 
Table 25 
Table 26 
Table 27 
Table 28 
Table 29 
Table 30 
Table 31 
Table 32 
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8. 0 Call Data Block Resource Manager 618 



API Table 

Call Data Block APIs 



Table 9 



Data Structure Table 
Call Data Block Table 
Leg Data Table 
Port Table 
Time Points Table 



Table 33 
Table 34 
Table 35 
Table 36 



9. 0 Service Logic Program Resource Manager 620 



API Table 

Service Logic Program APIs 



Table 10 



Data Structure Table 
Service Logic Program Table 



Table 37 



10.0 Switch Resource Resource Manager 622 



API Table 
Switch APIs 



Table 1 1 



Data Structure Tables 
Node Information Table 
Card Information Table 
Slot Table 
Node Table Type 
Span Map Table 
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Table 43 
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Table 44 
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Table 45 
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Table 46 


ivir usr J. able 


Table 47 


oiacK i aoie 


Table 48 
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Table 49 


LinK i aoie 


Table 50 


Destination Table 


Table 51 


Route Table 


Table 52 


S>55/ lable 


Table 53 


EXNET Table 


Table 54 


Facility Table 


Table 55 


Channel Table 


Table 56 


ISDN Card Table 


Table 57 


Other Card Table 


Table 58 


Card Union Table 


Table 59 



C. Description of Exemplary Resource Manager 

The call data block resource manager 618 is described with respect to 
Table 9 to provide an exemplary illustration of the information contained in the 
tables. The call data block resource manager 618 comprises call data block APIs 
and call data block resource manager tables. Call data block APIs are described 
in Table 9. Call data block APIs provide procedures for managing call data block 
information. Call data block information includes call related data obtained in 
processing a call and used to identify the call, elements of the call, such as the call 
legs, and provide information for billing the call, such as billing time points. The 
call data block resource manager tables are illustrated in Tables 33-36. 
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Exemplaiy cdb_GetCDBData API provides procedures for retrieving call 
data block information from the call data block table. Table 9 provides 
information about the call data block APIs. The first column provides the API 
name. In the exemplary API shown in the eighth row of Table 9, the first column 
indicates the name of the API is cdb_GetCDBData. The second column of Table 
9 indicates the function. With respect the exemplary API cdb_GetCDBData, the 
function is to get a CDB's detailed data. The third column of Table 9 provides 
input parameters. For the exemplary API, cdbGetCDBData, the inputs required 
are the 1 Cid, which is the call identifier, and the pstCDBData, which is the 
address of where the CDB data should be saved. The fourth column of Table 9 
provides the output of the API. For the exemplary cdb_GetCDBData API, the 
output is saving the CDB data at the pstCDBData address. The fifth column 
provides the return of the API. For the exemplary cdb_GetCDBData API, the 
possible returns are: CDB SUCCESS, CDBSHMNOTATTACH, 
CD B_KEY_IN VALID, CDB_INPUT_ADDR INVALID, 
CDB LOCK REC ERR, and CDB UNLOCK REC ERROR. 

D. Description of Other Resource Managers 

Additional resource managers are described in the tables. The semaphore 
resource manager 612 comprises semaphore APIs and semaphore resource 
manager tables. In Table 1, semaphore APIs are described. Semaphore APIs 
provide procedures for managing semaphore variables. Semaphore variables are 
UNIX constructs that lock and unlock memory segments. The semaphore 
variables within the switch controller 1 12 provide controlled access to data related 
to ISN resources. A set of semaphore variables is created for each table for access 
to the resource data stored in the table. Semaphore variables act as gatekeepers 
for memory by preventing multiple processes from accessing a particular memory 
segment simultaneously. The number of processes that may access a memory 
segment may be adjusted by modifying a configurable variable. The value of the 
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configurable variable establishes the threshold value of the number of processes 
allowed access. Two locking schemes for semaphore variables are locking of an 
entire table and locking of one entry within a table. The semaphore resource 
manager tables may be any semaphore table such as those traditionally used with 
UNIX platforms. 

The switch controller resource manager 614 comprises switch controller 
APIs and switch controller resource manager tables. The switch controller 
resource manager APIs and switch controller resource manager tables include (1) 
switch controller common library APIs, (2) operational measurements area APIs 
and tables, and (3) heartbeat APIs and tables. 

In Table 2, switch controller common library APIs are described. The 
switch controller common library APIs affect the switch controller common library 
memory segment. The switch controller common library memory segment 
supports shared memory used to store heartbeat information and provides an 
operational measurements area where processes can deposit statistical data. 
Switch controller common library APIs are used to create and delete the switch 
controller common library memory segment. In addition, switch controller 
common library APIs are used by routines to attach and detach from the switch 
controller common library memory segment. 

In Table 3, operational measurements area APIs are described. 
Operational measurements area APIs provide procedures for managing operational 
measurements data. Operational measurements data includes statistics of the 
components of the switch controller, such as disks, central processing unit (CPU) 
available memory, ports, and other similar data. Tables 12-18 provide additional 
information describing the tables used to store operational measurements data. 

In Table 4, heartbeat table APIs are described. Heartbeat table APIs 
provide procedures for managing heartbeat data. Heartbeat functionality is used 
to monitor the health of the processes within the switch controller 1 12. A process 
manager routine within the management interface function is responsible for 
sending heartbeat requests to other switch controller application program routines 
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116 within certain intervals. The recipient switch controller application program 
routines 116 are responsible for responding to the heartbeat requests within 
established intervals. Process management determines when and what action 
should be taken when a process is not responding in a proper manner. 

Heartbeat requests and responses are conveyed by setting request and 
response flags through shared memory. Heartbeating through shared memory is 
more efficient than heartbeating by sending messages through message queues 
because heartbeating through shared memory reduces the message volume within 
the switch controller. 

Use of shared memory for heartbeating is described. The shared memory 
segment used to perform heartbeating is referred to as the heartbeat area. In one 
embodiment, one of the switch controller application program routines 1 16 is- a 
process manager. A process manager oversees the heartbeating function and uses 
a resource management API to create the heartbeat shared memory segment. 
Within the shared memory segment, an entry is created for each switch controller 
application program routine 116. The entry contains heartbeat information, such 
as the switch controller application program routine identifier, heartbeat interval, 
heartbeat state (eg. register, request, or respond), request time stamp, and 
unresponded time and count. Heartbeat intervals can be set to different values for 
different switch controller application program routines 116. Table 18 provides 
an exemplary table used to store heartbeat data. Table 17 illustrates an exemplary 
control table used to control the heartbeat table. 

The process manager brings up each of the other switch controller 
application program routines 116. The switch controller application program 
routines 116 attach to the heartbeat segment. To initiate processing with a 
particular switch controller application program routine 1 16, the process manager 
uses a resource management API to register each switch controller application 
program routine's 1 16 heartbeat entry and establishes its heartbeating interval. 
The interval may be modified using another resource management API. 
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The process manager informs each of the switch controller application 
program routines 1 1 6 of the need for heartbeating by sending a message with the 
switch controller application program routine's 1 16 heartbeat handle. The process 
manager calls a heartbeat request API to indicate a heartbeat request. When the 
routine 1 16 receives an initial heartbeat setup message, it immediately calls a 
respond heartbeat API. Each time a process calls a respond API, it will get a time 
which tells the process when it should next call the respond API. The routines 
1 16 can get the current set heartbeat interval time using this API as well. Wbi 
switch controller application program routines 116 exit, they detach from the 
memory segment. During switch controller 112 shutdown, a delete heartbeat 
segment is called to remove the segment from the system. 

Additional resource managers are described in the tables. The agent 
resource manager 616 comprises agent APIs and agent resource manager tables. 
Agent APIs include APIs to manage agent, group, and agent assignment tables. 
Agent table, group table, and assignment tables are stored in one shared memory 
segment and share the same shared memory identifier. In Table 5, agent memory 
segment APIs are described. Agent memory segment APIs provide procedures 
for managing the agent memory segment. Agent memory segment APIs are used 
to create and delete the agent memory segment. In addition, agent memory 
segment APIs are used by routines to attach and detach from the agent memory 
segment. 

In Table 6, agent table APIs are described. Agent table APIs provide 
procedures for managing agent tables. Agent tables include information about 
agents, such as terminal identifiers, agent logon identifiers, and associated groups. 
After an agent establishes a connection with the switch controller and logs on, its 
operating state in an agent table will be updated as capable of processing calls. In 
addition, after the agent logs off, its operating state will be changed to unable to 
handle calls. An agent API is provided to find an agent within a particular group. 
In addition, APIs to dynamically add and delete an agent entry are also provided. 
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Tables 20-23 illustrate tables used to store information about agents. In addition. 
Tables 30-32 provide tables used to store general information about agents. 

In Table 7, group table APIs are described. Group table APIs provide 
procedures for managing the group tables. Agents are grouped together 
according to their call processing functionalities. Agent group information 
includes information about the groups, agents assigned to the group and the 
number of calls queued to the group. Tables 24-26 illustrate tables used to store 
agent group information. 

In Table 8, assignment table APIs are described. Assignment table APIs 
provide procedures for managing the assignment table. An agent group can have 
any number of agents assigned to it and an agent can be assigned to multiple 
groups. In order to describe the cross referencing between the agent table and 
group table, a separate agent assignment table is created. Tables 27-29 illustrate 
tables used to store agent assignment information. 

The service logic program resource manager 612 comprises service logic 
program APIs and service logic program resource manager tables. In Table 10. 
service logic program APIs are described. Service logic program APIs provide 
procedures for managing the service logic program table. The service logic 
program table contains call identifier, call feature, call state and event information. 
The service logic program table is separate from the call data block. The service 
logic program table is organized on the service level. If a service logic program 
terminates abnormally, the service logic program can attach to this table and have 
access to most of the information needed about the calls in progress. Table 37 
illustrates the table used to store service logic program data. 

The switch resource resource manager 622 comprises switch APIs and 
switch resource manager tables. In Table 1 1, switch APIs are described. Switch 
APIs provide procedures for managing switch data. 

Switch data includes switch matrix, card, node, span, trunk group, and 
other information related to the programmable switch 110 controlled by the 
switch controller 1 12. A switch matrix performs the switching functionality of 
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interconnecting two channels, a channel from the caller and a channel to the 
receiver, in order to switch a call to a final destination. A card is a microprocessor 
chip board that is programmed to perform a specialized functionality. Cards 
within the programmable switch 1 10 are programmed with different software to 
perform various functions. Nodes are points of interconnection in a 
telecommunications network. Spans are telecommunications cables, typically fiber 
optic, however any medium capable of transmitting signals may used, that 
interconnect two components in a telecommunications network. Channels are 
bandwidth allocations that may be assigned to a particular call. Trunk groups are 
designations within software that are used for traffic routing purposes. Channels 
are assigned to trunk groups and a particular trunk group routes traffic between 
the destinations interconnected by the channels assigned. When a call is received, 
the destination number is used to select an appropriate trunk group and route the 
call via a channel assigned to the trunk group to the destination. Tables 38-59 
provide additional information describing the tables used to store switch data. 

While various embodiments of the present invention have been described 
above it should be understood that they have been presented by way of example 
only not limitation. Thus the breadth and scope of the present invention should 
not be remitted by any of the above described exemplary embodiments but should 
be defined only in accordance with the following claims and their equivalents. 
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What Is Claimed Is: 

1 1 . A computer in a telecommunications network, comprising: 

2 a processor; and 

3 a resource management means for enabling said processor to 

4 provide standardized management of multiple resources including internal 

5 operational resources, external components, and applications processing data, 

6 wherein said resource management means comprises one or more resource 

7 managers, said resource managers being one of: 

8 a semaphore resource manager; 

9 a switch controller resource manager; 

10 an agent resource manager; 

1 1 a call data block resource manager; 

12 a service logic resource manager; or 

13 a switch resource resource manager; 

14 wherein each of said resource managers comprises: 

1 5 one or more resource manager application programmer interfaces 

16 that manage said internal operational resources, said external components, and 

1 7 said applications processing data; and 

1 8 one or more data storing means for enabling said processor to store 

19 data in table format related to said internal operational resources, said external 

20 components, and said applications processing data. 

1 2. A method for managing resources within a network, comprising: 

2 (i) sending a query to a resource manager, wherein said resource manager 

3 manages information corresponding to a resource, said resource manager 

4 complying with a common standard for resource managers within the network; 

5 and 

6 (ii) managing data stored in memory and organized in table format using 

7 said query; 
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8 wherein said data is one of: 

9 semaphore data; 

10 switch controller data; 

1 1 agent data; 

12 call data block data; 

13 service logic program data; or 

14 switch data. 

1 3. A computer, comprising: 

2 a processor; and 

3 plurality of application programmer interface means for enabling said 

4 processor which is connected to a memory, to provide an interface between one 

5 or more resource requesters and data organized in a plurality of tables, each of 

6 said plurality of tables corresponding to one of a plurality of resources, each of 

7 said plurality of application programmer interface means comprising: 

8 sending means for sending a query; and 

9 managing means for managing data stored in said memory 

1 0 and organized in table format using said query; 

1 1 wherein said application programmer interface means provides system- 

12 wide interface with said data; 

1 3 wherein each of said plurality of application programmer interface means 

14 complies with a common standard for application programmer interfaces. 

1 4. The computer of claim 1 , wherein said data within said data storing means 

2 comprises one of: 

3 switch controller data; 

4 call data block data; or 

5 service logic program data. 
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5. The computer of claim 1 , wherein said resource management means 
further comprises: 

a tabman resource manager; 
a queman resource manager; 
a sysmem resource manager; and 
a shmman resource manager. 

6. The method of claim 2, wherein step (ii) comprises the step of: 
updating said data stored in said memory and organized in table format 

using said query. 

7. The method of claim 2, wherein step (ii.) comprises the step of: 
retrieving said data stored in memory and organized in table format using 

said query. 



The computer of claim 3, wherein said data comprises: 
semaphore data; 
switch controller data; 
agent data; 
call data block data; 
service logic program data; and 
switch data. 



9. The computer of claim 3, wherein one of said application programmer 
interface means is one of: 

create table semaphore; 

initialize table semaphore; 

create semaphore; 

initialize semaphore; 

delete semaphore; 
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8 attach semaphore; 

9 lock semaphore table; 

10 unlock semaphore table; 

1 1 lock semaphore table entry; 

12 unlock semaphore table entry; 

13 lock semaphore one entry; 

14 unlock semaphore one entry; 

15 recover table semaphore; 

1 6 get semaphore size; 

1 7 get table semaphore value; or 

1 8 print semaphore. 

1 10. The computer of claim 3, wherein one of said application programmer 

2 interface means is one of: 

3 create switch controller common library memory segment; 

4 delete switch controller common library memory segment; 

5 attach switch controller common library memory segment; and 

6 detach switch controller common library memory segment. 

1 11. The computer of claim 3, wherein one of said application programmer 

2 interface means is one of: 

3 set up an operational measurements IPC; 

4 update an operational measurements IPC; 

5 print an operational measurements IPC; 

6 get an operational measurements attribute; and 

7 set an operational measurements attribute. 

1 12. The computer of claim 3, wherein one of said application programmer 

2 interface means is one of: 

3 get time; 



MCI Ref. No.: CDR-97-031 
SKGF Ref. No.: 1575.3000000 



-37- 



4 


create a heartbeat table; 


5 


delete a heartbeat table; 


6 


attach to a heartbeat table; 


7 


detach from a heartbeat table; 


S 


create a heartbeat entry; 


9 


delete a heartbeat entry; 


10 


yci a. ncdi lucdL nanaie, 


11 


request heartbeat; 


12 


respond heartbeat; 


13 


set heartbeat interval; 


14 


get heartbeat attributes; and 


15 


print heartbeat table. 



The computer of claim 3, wherein one of said application programmer 
interface means is one of: 
create agent segment; 
delete agent segment; 
attach agent segment; and 
detach agent segment. 

The computer of claim 3, wherein one of said application programmer 
interface means is one of: 
create agent entry; 
delete agent entry; 
update agent state; 
agent select; 

agent destination number to terminal identifier conversion; 
get agent data; 
set agent data; 
get agent attribute; 
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1 1 set agent attribute; 

12 get agent handle; 

13 get agent counts; 

14 print agent table; 

15 print agent entry ; and 

1 6 print agent search table. 

1 15. The computer of claim 3, wherein one of said application programmer 

2 interface means is one of: 

3 create group entry; 

4 delete group entry; 

5 get group handle; 

6 get group data; 

7 set group data; 

8 increase calls queued on group; 

9 decrease calls queued on group; 

1 0 get group count; 

1 1 print group table; 

1 2 print group entry; and 

13 print group search table. 

1 16. The computer of claim 3, wherein one of said application programmer 

2 interface means is one of: 

3 create assign entry; 

4 delete assign entry by keys; 

5 delete agent assign; 

6 delete group assign; 

7 get assign by keys; 

8 get assign count; 

9 get agent assign count; 
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10 get group assign count; and 

1 1 print assign table. 

1 17. The computer of claim 3, wherein one of said application programmer 

2 interface means is one of: 

3 create call data block table; 

4 delete call data block table; 

5 attach call data block table; 

6 detach call data block table; 

7 create call data block entry; 

8 delete call data block entry; 

9 call data block search call identifier by port identifiers; 

10 get call data block data; 

1 1 set call data block data; 

1 2 print call data block data; 

1 3 return call data block attribute; 

14 set call data block attribute; 

15 get number call data block entries; 

1 6 print call data block table; or 

1 7 print call data block entry. 

1 18. The computer of claim 3, wherein one of said application programmer 

2 interface means is one of: 

3 create service logic program table; 

4 delete service logic program table; 

5 attach service logic program table; 

6 detach service logic program table; 

7 create service logic program entry; 

8 delete service logic program entry; 

9 get service logic program data; 
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10 set service logic program data; 

1 1 print service logic program data; 

12 get service logic program attribute; 

13 set service logic program attribute; 

14 service logic program search call identifier by terminal identifier; 

1 5 get service logic program count; 

16 print service logic program table; or 

17 print service logic program entry. 

1 19. The computer of claim 4, wherein said data comprises one or more of: 

2 switch controller IPC data; 

3 switch controller CPU availability data; 

4 switch controller disk availability data; 

5 agent operational measurement count data, wherein said agent operational 

6 measurement count data is data collected for one or more agents controlled by 

7 a switch controller; 

8 a switch port operational measurement count data, wherein said switch 

9 port operational measurement count data collected for one or more switches 

10 controlled by said switch controller; 

1 1 control table data for control tables within said switch controller; or 

12 heartbeat data for heartbeating of routines within said switch controller. 

1 20. The computer of claim 4, wherein said data stored in said table format 

2 comprises: 

3 call identifying information; 

4 calling number; 

5 called number; 

6 call leg information; and 

7 billing time point information. 
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A System and Method for Resource Management 



Abstract 



A system and method of resource management is described. Within a 
telecommunications network, resources are sources of assistance in performing 
functions needed to process calls. The present invention is a system-wide 
approach to resource management that provides controlled access to information 
about resources. A resource management routine is described that comprises 
electronic libraries residing in memory of a computer system that store information 
about resources and resource management application programmer interfaces that 
are used to access the stored information. 
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Switch Controller Common Library Memory Segment APIs 



API 


Function 


Input 


Possible Returns 


CM_Create CMSegment 


Creates and initializes the 
sc_common shared memory 
segment, which is composed 
of OM area and heartbeat 
uiDic. v^rcaies anu initializes 
semaphore sets for OM and 
HB. Primarily used by the 
process manager. 


USMaxNoOf HBEntry 
- maximum number of 
HB entries 


CM SUCCESS 
CMFAIL 


CM_Delete CMSegment 


Deletes the sc_common 
share memory segment and 
its semaphore sets. 


None 


CM_SUCCESS 
CMFAIL 


CM_Attach CMSegment 


Attaches to the sc_common 
share memory segment. 


None 


CMSUCCESS 
CMFAIL 


CM Detach CMSegment 


Detaches from sccommon 
segment. 


None 


CMSUCCESS 
CMFAIL 
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Return 


SW SUCCESS 
SW SUM NOT ATTACH 
SW_NODE ID INVALID 
SW SLOT NO INVALID 
SW CARD TYPE INVALID 
SW LINKSET ID INVALID 


SW SUCCESS 
SW_SHM_NOT ATTACH 
SW NODE ID INVALID 
SW_SLOT_NO INVALID 
SW CARD TYPE INVALID 
SW LINK ID INVALID 
SW LINK ID INUSE 


SW SUCCESS 
SW_SHM_NOT ATTACH 
SW NODE ID INVALID 
SW SLOT NO INVALID 
SW_CARD~TYPE INVALID 
SW_LINK ID INVALID 


SW_SUCCESS 
SW SUM NOT ATTACH 
SW INPUT A DDR INVALID 
SW KEY INVALID 


SW SUCCESS 
SW SHM NOT ATTACH 
SW NODE ID INVALID 
SW SLOT NO INVALID 
SW_CARD_TYPE INVALID 
SW LINK Td INVALID 


SW SUCCESS 
SW_SHM NOT ATTACH 
SW NODE ID INVALID 
SW SLOT NO INVALID 
SW CARD TYPE INVALID 
SW_DEST ID INVALID 
SW_DEST ID INUSE 


Input 


usNodelD -- logical node ID 
usSlotNo slot no of the SS7 card 
stLinksetID -- linkset ID 


usNodelD -- logical node ID 
usSlotNo — slot no of the SS7 card 


stLink - link info. 






usNodelD ~ logical node ID 
usSlotNo - slot no of the SS7 card 
usLinkID -- link ID 


usSpanID -- logical span ID 
usChannellD -- channel ID 
pusNodelD - return logical node ID 
pusSlotNo — return slot no 
pusLinkID - return SS7 link ID 


usSpanID -- logical span ID 
usChannellD -- channel ID 


usNodelD -- logical node ID 
usSlotID - slot no of the SS7 card 
stDcst — destination info. 


Function 


Remove a SS7 linkesct. 


Add a link. 


Remove a link. 


Get SS7 link ID of a specified 
channel. 


Remove a SS7 link. 


Add SS7 destination. 


API 


ir. 
c 
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CO 


SW_AddLink 


SW_RemoveLink 


SW_GetLink 


SW_RcmoveLink2 


SW_AddDcst 
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Switch Controller Common Library Table 
Operational Measurements Area 
IPC Table 



(Contains information pertaining to shared memory, queues, and semaphores.) 



jt ieiQ 










ch Name 


IPC 1 


IPC 2 




IPCn 


I Key 










I Id 

(Identifier) 










I Size 










I Create 
Time 











Table 12 



Switch Controller Common Library Table 
Operational Measurements Area 
Switch Controller CPU Availability 



Field 


CPU A 


CPUB 




CPUn 


I Startup Time 










us Available CPU (percent) 










us Waiting CPU (percent) 










ul Total Memory 










ul Available Memory 










st Disk 


pointer to 
st Disk 
table 


pointer to 
st Disk 
table 




pointer to 
st Disk 
table 



Table 13 



Switch Controller Common Library Table 
Operational Measurements Area 
Disk Availability 



Field 










ch Name 


Disk 1 


Disk 2 




Disk n 


Total 










Available 











* 2-8 disks per CPU typical 

Table 14 



Switch Controller Common Library 
Operational Measurements Area 
Agent Operational Measurement 
Counts 

For Agents Controlled by a Switch Controller 



Field 


Counts 


ul Agent Total 




ul Agent Disconnect 




ul Agent Connect 




ul Agent Ready 




ul Agent Busy 





Table 15 



Switch Controller Common Library 
Operational Measurements Area 
Switch Port Operational Measurement 
Counts 
for a Switch Controller 



Field 


Counts 


ul Port Total 




ul Port Conference 




ul Port Out 




ul Port In 




ul Port Hold 





Table 16 



Switch Controller Common Library 
Control Table For Heartbeat Table 



Field 


Value 


Comments 


us Max Element 




max element index in the table 


us Use Element 




first element in the used list 


us Free Element 




first element in the unused list 


us Use Counts 




element count 


us Stand Alone 




table is a standalone segment flag 



Table 17 



Switch Controller Common Library 
Heartbeat Table 



Field 










Comments 


IPid 


Process 1 


Process 2 




Process n 


Process Identifier 


s State 










May be register, request or 
respond 


us Interval 










Heartbeat interval 


us Half 
Interval 










Half of the heartbeat interval 


d Request 
Time 










Last request time stamp 


us Unrsp 
Count 










Heartbeat unrespond counter 


us Unrsp time 










Unresponded elapsed time 


h Prev Handle 










Previous handle 


h Next Handle 










Next handle 


ch Entry Used 










Entry used flag 



Table 18 



Agent Library 
Control Table for Agent Table 



Field 


Value 


Comments 


us Max Element 




Max element index in the table 


us Use Element 




First element in the used list 


us Free Element 




First element in the unused list 


us Use Counts 




Element count 


us Stand Alone 




Table is a stand alone segment flag 


st Agent Count 




Agent count 



Table 19 



Agent Library 
Agent Table 



Field 










Comments 


st Agent Data 










Agent data substructure 


h Assigned 










Assigned groups 


h Client Handle 










Client handle 


h Prev Handle 










Previous agent handle 


h Next Handle 










Next agent handle 


ch Entry Used 










Entry used flag 



10 Table 20 



Agent Library 
Agent Attributes Table 



Field 










Comments 


ITid 


Agent 
Tid 1 


Agent 
Tid 2 




Agent 
Tidn 


Agent terminal identifier 


st Agent DN 










Agent destination 
number 


uch Agent Logon ID 










Agent logon identifier 


st Agent Attr 










Agent attribute structure 


st Last Logoff Cause 










Last logoff reason 


s State 










Agent state 



20 Table 21 



Agent Library 
Agent Time Stamps Table 



Field 


Agent 
Tid 1 


Agent 
Tid 2 




Agent 
Tidn 


Comments 


I Last Connect Time 










Last logon time 


I Last Ready Time 










Last become ready time 


I Last Busy Time 










Last become busy time 


I Last Disconnect 
Time 










Last log out time 



Table 22 



10 Agent Library 

Agent Count Table 



Field 


Value 


Comments 


us Total 




Total Agent Entries 


us Disconnect 




Total Agents in Disconnect State 


us Connect 




Total Agents in Connect State 


us Ready 




Total Agents in Ready State 


us Busy 




Total Agents in Busy State 



Table 23 



Agent Library 
Control Table for Group Table 



Field 


Value 


Comments 


us Max Element 




Max element index in the table 


us Use Element 




First element in the used list 


us Free Element 




First element in the unused list 


us Use Counts 




Element count 


us Stand Alone 




Table is a stand alone segment flag 


us Calls Queued 




Total number of calls queued 



10 Table 24 



Agent Library 
Group Table 



Field 










Comments 


st Group Data 


Agent 
Group 1 


Agent 
Group 2 




Agent 
Group n 


Group information • 


h Assigned 










Agents belonging to this 
group 


h Prev Handle 










Previous group handle 


h Next Handle 










Next group handle 


ch Entry Used 










Entry used flag 



Table 25 



Agent Library 
Calls Queued Per Group 



Field 










Comments 


uch Group Num 


Agent 
Group 1 


Agent 
Group 2 




Agent 
Group n 


Group identifier 


st Agent Count 










Number of agents in this 
group 


us Calls Queued 










Number of calls queued in 
this group 



Table 26 



Agent Library 
Control Assignment Table 



Field 


Value 


Comments 


us Max Element 




Max element index in the table 


us Use Element 




First element in the used list 


us Free Element 




First element in the unused list 


us Use Counts 




Element count 


us Stand Alone 




Table is a standalone segment 
flag 



Table 27 



10 Agent Library 



Assignment Table 



Field 


Agent 
Group 
1 


Agent 
Group 
2 




Agent 
Group n 


Comments 


st Assign Data 










Assignment data field 


h Agent Prev 
Handle 










Agents previous assignment 


h Agent Next 
Handle 










Agents next assignment 


h Group Prev 
Handle 










Group's previous assignment 


h Group Next 
Handle 










Group's next assignment 


h Prev Handle 










Previous assignment handle 


h Next Handle 










Next assignment handle 


ch Entry Used 










Entry used flag 



25 Table 28 



Agent Library 
Assignment Data Table 



Field 










Comments 


h Agent Handle 


Agent 
Handle 1 


Agent 
Handle 2 




Agent 
Handle n 


Agent table handle 


h Group Handle 










Group table handle 



Table 29 



Agent Library 
Mapping Table 



Field 










Comments 


ITid 


Agent 
Tid 1 


Agent 
Tid 2 




Agent 
Tidn 


Terminal identifier 


h Agent Handle 










Agent table handle 


ch Entry Used 










Entry used flag 



Table 30 



Agent Library 

15 Fast Search for Agent Table 



Field 










Comments 


ITid 


Agent 
Tid 1 


Agent 
Tid 2 




Agent 
Tidn 


Agent terminal identifier 


h Agent Handle 










Agent table handle 



Table 31 



Agent Library 
Group Search Table 



Field 










Comments 


uchGroupNum 










Group Number 


h GroupHandle 


Group 
Handle 1 


Group 
Handle 2 




Group 
Handle n 


Group Handle 



Table 32 



Call Data Block Library 
Call Data Block Table 



Field 










Comments 


ICid 


Call ID 
1 


Call ID 
2 




Call ID n 


Call identifier 


stANI 










Calling number 


st DN 










Called number 


st O Leg 


Legl 








Originating leg 


st T Leg 


Leg 2 






Leg n 


Terminating leg 


stTP 










Time points 



Table 33 



Call Data Block Library 
Leg Data Table 



Field 


Legl 


Leg 2 


.... 


Legn 


Comments 


of Pnrt 
ol run 










Switch port associated with 
leg. 


us State Machine 
Id 










State machine identifier. 


us State 










State of leg. 


us Event 










Event occurring on leg. 


us Conf Port 










Conference port. 



10 Table 34 



Call Data Block Library 
Port Table 



Field 










Comments 


s Span ID 










Span identifier 


s Channel ID 


Channel 
1 


Channel 
2 




Channel 
n 


Channel identifier 



Table 35 



Call Data Block Library 
Time Points 



Field 


Call 
ID I 


Call 
ID 2 


.... 


Call 
ID n 


Comments 


ulTPl 










Time point 1 which is the time the switch controller 
detects an incoming call. 


ul TP4 










Time point 4 which is the time a call is offered to an 
agent position. 


ul TPS 










Time point 5 which is the time the agent port is done 
with a call. 


ulTP6 










Time point 6 which is the time at which the switch 
controller detects answer supervision from the 
terminating end. 


ul TP7 










Time point 7 which is the time at which controller detects 
reorigination DTMF sequence, originator disconnect, 
CSH timer expiration indicating terminator disconnect, or 
call park timer expiration(whichever occurs first). At 
time point 7, the switch controller may send time points 
to the billing system. 



Table 36 



Service Logic Program Library 
Service Logic Program Table 



Field 

Mr IvlU 










Comments 


1 Cid 










Call identifier 


1 TiH 










Agent terminal identifier 












Feature of the call 


£> JTCcHUlC OldlC 










estate ot the feature 












Feature of the leg 


o JL-A.lJtVl.VLl U/Vwill 










Expected event 


1 Relate Pid 1 










Kelated Call ID 1 


1 Relate Pid ? 










Related Call ID Z 


1 Relate ("Sri 1 










Kelated Call ID J 


1 Relate Cid 4 










iveiaieu v^aii iu 4 


1 Relate Cid 5 










Related Call ID 5 


1 Relate Cid 6 










Related Call ID 6 


1 Relate Cid 7 










Related Call ID 7 


1 Relate Cid 8 










Related Call ID 8 


1 Relate Cid 9 










Related Call ID 9 



Table 37 



A163-01.wpd 



Switch Library 
Node Information Table 



Field 










Comments 


us Node ID 


Node 1 


Node 2 




Node 3 


Logical node identifier for the switch. 


IPhysical ID 










Node serial number. 


US Host Node ID 










Host node logical identifier 


S SWType 










Switch system type (LNX, CSN) 


US MaxSIot 










Maximum number of slots. 


sStatus 










Status of the node. 



Table 38 

Switch Library 
Card Information Table 



Field 










Comments 


usSlotNo 










stat number 


eCard Type 










card type 


Sserial Number 


Card 

Serial No. 1 


Card 

Serial No. 2 




Card 

Serial No. 3 


card serial number 


eCardStatus 










status of the card 


sConfigTag 










configure tag if any 


sCardRole 










primary, secondary etc. 


usMatchSlot 










matching front or rear slot 



Table 39 

Switch Controller 
Slot Table 



Field 


Slotl 


Slot 2 




Slotn 


Comments 


stCardlnfo 










generic card info 


pvCard 










specific card info 


ulCardEntrySize 










card entry size 


chEntryUsed 










entry used flag 



Table 40 



Switch Library 
Node Table Type 



Field 


Node 1 


Node 2 


... 


Node 3 


Comments 


stNodeData 










node data 


stSlotMap 










slot map 


stLineCard 










line cards 


stMFDSPCard 










MFDSP cards 


stCPUCard 










CPU cards 


stSS7Card 










SS7 cards 


stISDNCard 










ISDN cards 


stEXNETCard 










EXNET cards 


stOtherCard 










other types of card 


chEntryUsed 










entry used flag 



Table 41 



Switch Library 
Span Map Table 



Field 










Comments 


usLogSpanID 


Span ID 1 


Span ID 2 




Span ID 3 


logical span ID 


chEntryUsed 










entry used flag 



Table 42 

Switch Library 
Line Card Table 



Field 


Line Card 1 


Line Card 2 




Line Card n 


Comments 


stCardlnfo 










generic card info 


usMaxSpan 










# of spans (4, 8) 


usMaxChannel 










# of channels on each span 


stSpanMap 










physical to logical map 


chEntryUsed 










entry used flag 



Table 43 
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Switch Library 



CPU Card Table 



Field 










Comments 


stCardlnfo 










generic card info 


chlPAddr 










Internet protocol address 


sConnectState 










Connect state 


1 SocketID 










Socket identifier 


chEntryUsed 










entry used flag 



Table 44 



Switch Library 



DSP Table 



Field 


DSP1 


DSP2 




DSPn 


Comments 


eFuncType 










function type of the DSP 


sStatus 










status of this DSP 


usMaxResource 










max resources of this type 


usCurrUsed 










current used resource 


chEntryUsed 










entry used flag 



Table 45 



Switch Library 
Simm Table 



Field 










Comments 


US Simm ID 


Simm ID 
1 


Simm ID 
2 




Simm ID 
3 


Single inline memory 
module (SIMM) identifier 


eSimmType 










SIMM type 


sStatus 










status of this SIMM 


usNoDSP 










# of DSPs on this SIMM 


stDSP 










DSP structure 


chEntryUsed 










entry used flag 



Table 46 
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Switch Library 
MSDSP Card Table 



Field 


Card 1 


Card 2 




Card n 


Comments 


stCardlnfo 










generic card info 


usNoSimm 










# of simms on the card 


stSimm 










simm card structure 


chEntryUsed 










entry used flag 



Table 47 



Switch Library 
Stack Table 



Field 










Comments 


usStack ID 


Stack ID 1 


Stack ID2 




Stack ID3 


stack identifier 


ulOPC 










OPC 


S S 7Mod VarEnum 
eMTPVariant 










Message transfer part 


SS7ModVarEnum 
elSUPVariant 










Integrated Service Digital 
Network (ISDN) User 
Part (ISUP) 


SS7ModVarEnum 
eL3P Variant 










eL3P 


chEntryUsed 










entry used flag 



Table 48 



Switch Library 
Linkset Table 



Field 










Comments 


usLinkset ID 


Linkset ID 1 


Linkset ID 2 




Linkset ID n 


Linkset identifier which 
should be one byte 


ulAPC 










adjacent point code 


usStackID 










stack identifier 


chEntryUsed 










entry used flag 



Table 49 
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Switch Library 



] 


Ank Table 


Field 










Comments 


us LinkID 


Link ID 1 


Link ID 2 




Link ID n 


Link identifier 


usStackID 










Stack identifier 


usLinkset ID 










Linkset identifier 


usSLC 










one byte (OxOO-OxOF) Signaling Link Code 


usDataRate 










one byte (0x00-64 Kbps, 0x01-56 Kbps) 


usSpanID 










span ID (two bytes) 


usChannellD 










channel (one byte) 


chEntryUsed 










entry used flag 



Table 50 



Switch Library 



Destination Table 



Field 










Comments 


usDestID 


Dest ID 1 


Dest ID 2 




Dest ID 3 


destination identifier 


ulDPC 










destination point code 


chEntryUsed 










entry used flag 



Table 51 



Switch Library 
Route Table 



Field 










Comments 


US Route ID 


Route ID 
1 


Route ID 

2 




Route ID 
n 


Route identifier 


usStackID 










Stack identifier which is 
one byte one byte 


ulDPC 










destination point code 


usLinksetID 










Linkset identifier 


usDestID 










destination identifier 


sPriority 










priority of the route (byte) 


chEntryUsed 










entry used flag 



Table 52 



Field 



stCardlnfo 



stStack 



stLinkset 



stLink 



stDest 



stRoute 



chEntryUsed 



Switch Library 
SS7 Card Table 



SS7 
Card 1 



SS7 
Card 2 



SS7 
Card n 



Comments 



generic card info 



stack type 



linkset type 



link type 



destination type 



route type 



entry used flag 



Table 53 
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Switch Library 
EXNET Card Table 



Field 


EXNET 
Card 2 


EXNET 
Card 2 




EXNET 
Card n 


Comments 


stCard Info 










Generic card information 


usRing ID 










Logic ring identifier 


chEntry Used 










entry used flag 



Table 54 



Switch Library 
Facility Table 



Field 










Comments 


usFacSpan ID 


Facility 
Span ID 1 


Facility 
Span ID 2 




Facility 
Span ID n 


facility span identifier 


chEntryUsed 










entry used flag 



Table 55 



Switch Library 
Channel Table 



Field 










Comments 


usSpanID 










span identifier 


usChannellD 


Channel ID 1 


Channel ID 2 




Channel ID n 


channel identifier 


sFeature 










FAS orNFAS 


sRole 










primary, or secondary, 
independent 


usRelatedChannel 










related channel 


chEntryUsed 










entry used flag 



Table 56 
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Switch Library 



ISDN Card Table 



Field 


ISDN 
Card 1 


ISDN 
Card 2 




ISDN 
Card n 


Comments 


stCardlnfo 










generic card info 


usNoDChannel 










number of D channels 


stDChannel 










D channel type 


chEntryUsed 










entry used flag 



Table 57 



Switch Library 
Other Card Table 



Field 










Comments 


stCardlnfo 










generic card info 


chEntryUsed 










entry used flag 



Table 58 
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Field 



stCPUCard 



stLineCard 



stMFDSPCard 



stSS7Card 



stISDNCard 



stOtherCard 



stEXNETCard 
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Switch Library 
Card Union Table 



Table 59 



Comments 



CPU card 



Line Card 



MFDSP Card 



SS7 Card 



ISDN Card 



Other Card 



EXNET Card 



C 
7' 
- 



Cm 
3 



< 
<U 

« 

H 

-*-■ 
c 

<u 



C 

93 

s 

« 



Q. 
C 



g 
co 

c 

^ ° 

o W 
| Q 

eo 



< 

O t3 

s > 



CO 

e -o 

§ "S 
a " 



CO 

E •§ 

CO <" 
Z 



by 

N S3 



T3 
O 

5 
co 
n. 



o 



c 
.22 
"o 

CL 
CL, 
00 

Z 

CO 

•o 

< 



cfl 

<0 O 
T3 T3 

•a c 

re re 

Q « 
Z£ 
-a ° 
<= 52 
« •£ 

£ I 

§ I 

c * 

co 

^ I 
>>:= 



a. 



T3 

•a 
< 



o 

fc 

co 

c 
o 

o w 

1=1 J 

g Q 

?I 

o S 

<0 J 



5 On 

§ 5 



I Q 
z 5 



esc 

a y "5 

N jo 
</) CL 



CO CO 

to Q 



CL, 

Q 
D 

-a 

< 



CO 

•a 
c 
re 

K 

W 
•-J 
Q 
Z 

S 2 

9 > 

J o 
< c 

> .2 



H W 5 

•a y ^ 

CO > CO 

T CcS 03 

S en 1 » 

♦j re 

— > "^.JS 



re <u 
.C to 



t> CO 



S W 2 
— U 
CcJ J 



CO 

Q "O 

CO 



t3 
CO 
CO CO 

c x> 



indie 


CO _ 

E -5 


it hi 


re *o 

C CO 


CO 


c n 

CO u 


"o 
1 




JO 


1 1 

CO L, 


•a 
e 


ientNam 
lientAdd 


entHa; 


o 


szCl 





c 



CO 



— 

co 2 

«5 a 

•S .52 

Q o 



U 



o 

c 
,o 



^2 
c 

« j= 

- re 
E 



o 
c 



Q 
< 



c 

CO 



I'- 

<C CO 

> E 
Z 



XI 

•a 

it! S 
co C. 
CO T3 
O. -O 

"» CO 

Is 

" z 

c -a 

.32 c 

o 83 
_ <u 
re e 

£ I 
§ .52 



T3 

a 

,0 



_co 

T3 



CU 
J 
Q 
Z 
< 
X 

Q 1 
■J 
< 
> 
Z 



5 -c — j= 



CO 

£ a 

CO CO 

c ia 

CO 

C i 

.52 u. 

— T3 

0 ^ 

CO cu 

1 Q 
z 5 

? c 

C CO 

CO .— • 



CO 

a Q 



11 

-1 o 



O 

U 
U 

o 



CO 



CO 



CO 
i—l 

a 

to 



CO 



T3 2 "S 
_g 4) O CL 
w C 3 — 



1,3 ,- £ 

C T3 " 

« — 

«= 3 2 _ 

S CO CO CO «. 

.co £ ~ tc 2 

? o||<g 

J2 o o <t! 5 
•d (2 u o ^ 

C "a rS 



re 
c S 

y o 



o 
CQ ,22 



(O C 
~— CL 

.i ,?? 



re 



a 

o "g 

T3 CL 

CO 

— « 

o *"* 

§ re 

O CO 



u 
u 

I 

Q 

< 

m 

o 
U 

I 

o 



u 

I 

Q 

< 

ca 

o 

U 

o 

I 

o 





u 


°, 


o 


Q 


D 


< 


< 


a 


CQ 




i— 


o 


o 


U 


O 










o 


o 



T3 



1> 
C 

c 

o 



51 

o 



5 =? 



Ui 
GO 

-J 
< 

t~ 
o 

D 



•o 
c 

CC 

J3 
T3 

"re 
> 

I 

W 
go 
J 
< 
fcu 

o 
w 
D 



T3 



U3 

-J 

o 
f- 



<l> 



<1> 

'o 
c 



ui 

GO 
< 

o 
w 

el 
H 



3 

fi. 
-•— ■ 

S 

o 



< 



re 
H 

U 



o 



■O i 

US Si 

J3 O. £2 



o 
•o 



O 



Q 
c 

y 

a 



•o 
o 



IS O 



o <4- 2 



t3 5 



« ,1) 

J3 St; 



5 J. s 

= « ~ 
.2 sH € 



O 

IU 1 

.a ,b e 

« m g 

' 3 43 

.a j= o, 

oo o o 



- "I 
•o _i 

c 2 
« a> 

"5 1=3 

c o 

~ -s 

*o *+-« 

■ o 

CO O 

53 ^ 

C Id 
« ci5 



1*8 



S N 

— go 

o t« 



■4-. CO 

<= 

13 c 

CO ™ 

° >, 

s -° 

c o 

O «J 

!3 « 



T3 



C 

" is 



T3 
O 



3 



o 
o 

a 

O 
u 
c 



c 



•a 
e 
re 

K 

c 

o 
X 



n 
o 



c 

c 
U 



c 
re 



T3 

c 

re 

se 



u 



c 



XI 

c 

re 



73 
C 



c 

c 
.32 
"o 

a> 

T3 
C 
re 

X 



c .S3 "O 

& -3 =2 

cn 3 re 

£ -a ""i 
^ re o 
» I) 'C 

GJ 2 W 
W5 ^ 

«3 E C 

s o .se 

Q is Tj 



re J> 

r- < 

« o 

S o 



00 
re w 

o "8 



D5 o 



T3 
C 

re 



a> Tr> 

S c 



J3 

O -a 



CO cn 
o 1c 



■c 2 

§ S3 
-a u 

8 2 
8- 3 

« 8 

D. 

o , 



CD 
(U 

a) ^ 

■S c 
re 

b a 
= ^ 
'5 " 
o. >. 

S2 

E «c 

P 'o 



-a 



^4 



T3 

c 
re 



c 



T3 



a. 



* L 

U -3 



3 

□ 

33 



1 



Oh 

< 

23 

H 
u 
o 



v 

CO 

O 

Q 

cu 
u 

"E 

S 

05 

£ 

03 

H 



fc 

1- c 

O O 

-O i-J 

b Q 
c 

1> Q 

s < 

<U > 

-B ~7 



E 



•§-.9- 

U 1— 



a. °> 
-■^ B 
f— ■ « 

Q o 



CO 
> 

c 



OJ 

Q 

< 

I 

Q 

> ^ 



s c 
s . 



.a «: o 
£oo'.b 



= < 



P tio _ 
HQ 



- -a 



c 

CO 



o 
a. 



-o 

b 



< 
03 
i— 
o 

CJ 

o 

I 

o 



o 
n. 



CO 



Q 



o 
c 

I 

w 
° a 
41 * 
« 3 

CO I 

s 



£ 

CO 

c 

I— 

o 

■*-» 



cu 

-o 



u 
to 
cu 
Q 





u 




cj 




Q 


< 


< 


m 




t-i 


l. 


o 


o 


CJ 


U 


u 




*' 




o 


o 



3 
03 



o 



^ .2 
fi « 
<0 _ 

-B .S 

■« 
? 

o "o 

s.« 

'C «j 

o .£ 

vi 

aj c«-t 

•a o 



•a R 



T3 <*- 
E O 

go 



§ <a 0 
£ a - 

b n 

.s- ■ "s 



3 



t3 

a -o 

1_ o 
o o 
is o 



•o 0 

■ o 

CO oo 

m i ti 



Q 3 
J3 



U 
°. 

Q 
< 
03 

o 
U 
U 

o 



Q 
o 

D 

,< 



CX -o 

H ca 

If 



T3 

s 

CO 



= > 

V CO 

2 o 

.s-t: 

1) 3 
T3 43 



o 



c*-i S 
C CO 



3 



P-S 



Q. 2? 



q. a. 



o 



o 
o. 



•o 



T3 ^ 
< S 



< 



— CJ 

w .a 

o > 



c/l .2 

to 5 d 

c « « 

Qo c 



B cj 

2 g 
.S- <u 

DO > 

-O *> 
1) o 

co a. 

■Si 
5"? 



CO & 

«*- 2 
in i) 

s ° 

O tx 

CJ -a 



IS «J 

'3 .s 

3 



u ^ 

K o 

B u 
1) ^ 

<u c 

J= CO 

° <u 3 
O T3 XI 



Q 



T3 
t-. 
O 
o 

o 



o 



a. 
o 

CJ bO 

•a <u 

« D 

oS a> 

a -s 



a 



u 
u 

P 1 

< 
m 

o 

(J 
o 



D 1 
< 
CQ 



O 

I 

o 



•a 



^5 



£ 
2 



<L> 
S 

£ «> 

■sj 

ts o 
JS c 
u 

' w 

£ < 



s 

c 

s 
O 



3 



<u _ 

O 4> 



3 T3 
"1 



a. 
o 
o 

Q 



O .£2 



B -a Jr; 



.B* 5 
c " - 



•BO" 1 

« ,2 -a 



-a C. 
c o 



3 



o -53 



o l> 



c3 



«> oo 

^3 C/5 



4> 
T3 O 

C O 

9 o 

.£2 (A 



2 t 



■So 

is W5 
o. i 
*- o 

<-> N 

«> 00 
(/) 



O 

a. 



« a 

° S 

O CO 

►3 -o 



C 

o . 



2 

O 

o 

o 
o. 



0> 



a 



o 



< 



00 

o 
Q 

a 



TO 
> 



Ui 

a 

< - 

EC ^ 



Sn'fc 
us tz <u 

.a < £ 



3 

s 
O 



H 

u 

CJ 



0> 

CO 

c 

05 



eg 
H 



a. 
< 



-a 
c 

TO 

T3 & 

o <u 
. 



=5 ^ 

C o 

<u in 

CJ Q 



T3 JO 



oo 

< 



W 

a 

tu < 



T3 
S 
TO 

J3 



C 

TO 



00 



O CO 

a> 

<L> -O 

a s- 



Q 



cj 
< 

CQ 
t-i 
o 

O 

o 



3 
CQ 

O 

a. 



I— • • « 



£ 2 

3 <u 



" 2 I 



a. 
2 8 

•S .9 



ST 

« o 

1 ?S 

oo O 53 



TO ,<U 

o -° 



G 

o 2 



OS 



Q 
< 
CQ 

o 
CJ 

o 



<+-! 

3 
CQ 

s 

00 
H TO 

u u 



1 £ 

•= TO 

.2 -a 
•go 



u 
o 



■ JO 

JB ■ 
<2 £ 8 



J* - 

f sS 

C 3 
-C jo 

c & 
>• o 

Q E 

TO <U 



3 

CQ 



c 
Q 



a B to . v, 



u 

en 3 U 
3 JO J2 



U5 

o -SJ 

u O 



^> i-: 

TO C 
~ 3 
8 CQ 

is 

-t= .y § to 

*^ C o 



o 

'Es 

C/3 4-* 



0> 



— CO 

4> 



o o 



o 



CJ 
U 

I 

Q 
< 
CQ 
i— 
o 

CJ 

u 

O 



•a c 

§ Is 

&l 

So? 

1 O M 

oo o S 



2 



o 



u 1 

tO f4-H 

sis 



2 
•a 

O 



o- jS 



a 
a' 

< 

CQ 
t-< 
o 

CJ 
CJ 

o 



o 

TO 

"5 

<u 



•a 

TO 



•go 



TO I » 



•Si 



PC "St 



oo o 



tu 



o 

T3 



4> 

i- o 



oS 



Return 


Service count 
BAD CC on error 


TRUE - locked 

FALSE - invalid service handle 


TRUE - locked 

FALSE - invalid service handle 


Output 








Input 


None 


hClientHandle - client handle 
hServerHandle - service handle 


hClientHandle - client handle 
hServerHandle - service handle 


Function 


Get the number of service entries. 


Lock the service entry. 


Unlock the service entry. 


API 


GetServiceCount 


LockService 


UnLockService 
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TABMAN CLIENT TABLE DATA STRUCTURE 



typedef struct ClientTableTyp 

{ 

CHAR achClientName [NIDS_CLIENT_NAME_LEN] ; 







/* client name 


*/ 


T IQHHDT 
UonUK 1 


usAddressFamily; 


/* NIBS address or UP address 


*/ 




stClientAddress; 


/* client address 


*/ 


iNljJo UJJJr oUL-Jts. 


ADDRESS 








StClientUDPAddress; 


/* client UP address 


*/ 


T IT OTvin 


ulLastReceived; 


/* last packet received time 


*/ 


0 11 w i\ 1 


sWDCount; 


/* unresponded watchdogs 


*/ 


USHORT 


usCurrentPacketNum; 


/* control data 


*/ 


USHORT 


usReceivedPacketNum; 


/* last received packet sequence num. 


*/ 


USHORT 


usLastSendablePacketNum; 








/* last sendable packet seq. num. 


*/ 


USHORT 


usClientsLastSendable; 


/* client last sendable packet 


*/ 


VOID 


*pstNewList; 


/* new packet list 


*/ 


VOID 


*pst01dList; 


/* old packet list 


*/ 


BOOL 


ProtectField; 


/* used by table handler 


*/ 


BOOL 


fClientUsed; 


/* Client entry used 


*/ 


USHORT 


hServiceHandle; 


/* Service Handle 


*/ 


USHORT 


hNextClientHandle; 


/* handle of next client (used element) 


*/ 


USHORT 


hPrevClientHandle; 


/* handle of Pre client (used element) 


*/ 


} ClientTableTyp; 
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TABMAN SERVICE DESCRIPTOR TABLE DATA STRUCTURE 



typedef struct DescTableTyp 
{ 

CHAR achServiceName [NIDS_SERVICE_NAME_LEN] ; 







/* service name 


*/ 


UCHAR 


uchServiceType; 


/* service type flag 


*/ 


BOOL 


fDisabled; 


/* service status 


*/ 


USHORT 


usConsoles; 


/* number of clients 


*/ 


QHAND 


hQueueHandle; 


/* handle of process queue 


*/ 


VOID 


*pvMessage; 


/* pointer to any message that you 


*/ 






/* may want to store 


*/ 


ULONG 


ulHostSendDiskQues: 


; /* Disk queues for a particular Hostsend 


*/ 


ULONG 


ulBdrSendDiskQues; 


/* Disk queues for a particular Bdrsend 


*/ 


DescTyp 


stDesc; 


/* union of service description 


*/ 


BOOL 


ProtectField; 


/* used by table handler 


*/ 


BOOL 


fServiceDescUsed; /* 


Service Desc Used ? 


*/ 


USHORT 


hServiceHandle; 


/* handle to service table 


*/ 


USHORT 


hNextDescHandle; 


/* next service description 


*/ 


USHORT 


hPrevDescHandle; 


/* Prev service description 


*/ 



} DescTableTyp; 
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TABMAN SERVICE TABLE DATA STRUCTURE 



Typedef struct ServiceTableTyp 



SrvcTyp 


stSrvc; 


/* 


service type 


*/ 


QHAND 


hQueueHandle; 


/* 


handle of process queue 


*/ 


void 


*pLocalRespMsg; 


/* 


Call reorigination 


*/ 


BOOL 


ProtectField; 


/* 


used by table handler 


*/ 


BOOL 


fServiceUsed; 


/* 


Service Used ? 


*/ 


USHORT 


hClientHandle; 


/* 


client handle to client table 


*/ 


USHORT 


hNextClientService; 


/+ 


next client Service 


*/ 


USHORT 


hPrevClientService; 


/* 


Prev client Service 


*/ 


USHORT 


hNextServiceHandle; 


/* 


forward next service 


*/ 


USHORT 


hPrevServiceHandle; 


/* 


backward next service 


*/ 


USHORT 


hDescHandle; 


/* 


Service Description Handle 


*/ 



} ServiceTableTyp; 
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